固化用例

使用场景

AREX 可以将线上的真实流量录制下来从而生成丰富的测试用例，你可以根据需要从中筛选出某些重要用例，并进行固化（保存），扩充测试用例数量，后续还可以使用这些可复用的用例进行常态化的定时回归验证。

提示

可以在录制用例列表和回放用例列表中保存用例，两种固化用例仅接口地址存在差异：

从录制用例列表处保存的用例，尚未经过回放测试，因此这些用例请求的接口地址指向的是录制环境。
从回放用例列表处保存的用例，其请求的接口地址对应回放环境。
用例固化后的用例不会过期，长久有效。

固化录制用例

应用录制到请求后，点击应用名查看录制列表。

录制列表

找到需要固化的用例，点击 Record ID 查看录制详情。

录制列表

点击右上角 Debug 按键，进入调试界面。

录制列表

点击右上角 Save 进行保存。保存路径可以选择 AREX 默认生成的路径，也可以自定义保存路径。

固化回放用例

在完成一次回放测试后，进入回放报告页面。
点击 回放 Case 查看录制到的测试用例。
点击相应的用例，Failed 用例（即回放与录制返回报文出现差异的用例）下方将展示具体的差异细节。
Point of difference：展示回放测试中出现的所有差异节点。对于主接口的验证，主要验证录制与回放响应报文之间的差异，对于其他外部调用的第三方依赖的验证，则通过比对其请求内容（如数据库的 sql 语句）进行验证。
Scene Count：出现该差异点的场景数。
Additional node：录制或回放后的返回报文中多出的节点。如有，差异点会在报文中以橙色高亮显示。
Difference node：录制及回放后的返回报文中不同的节点。如有，差异点会在报文中以蓝色高亮显示。
提示
界面中展示的是在本次回放测试中设定的回放范围内录制到的所有测试用例。
点击 Record Detail，在新跳转的页面中展示该录制用例的详细信息：
前面已经提到过，AREX 对于主接口的验证，主要是比对录制与回放后响应报文之间的差异，对于其他外部调用的第三方依赖的验证，则通过比对其请求内容进行验证。左侧为录制过程中一些动态类及外部调用的第三方依赖（比如数据库等）的请求内容，以及主接口的响应体。右侧则为回放过程中调用的第三方依赖的请求内容及主接口的响应体。
点击保存该用例，并保存至刚才新建的集合请求中。

查看固化用例

用例固化后，可以在相应的集合请求下找到，界面与请求界面相似。

点击 Edit Label 为该用例添加标签，进行分类，方便之后使用。

查看用例

提示

标签需要提前在工作区设置页面进行预设。

管理标签

请求地址处为接口路径，如需回放调试可直接在路径前添加本地测试端口地址。

Header 中新增的 arex-record-id 为本次录制 ID，如需回放可在新建请求的请求头中添加该 arex-record-id，发送请求即可完成回放。

查看用例

固化用例，不仅可以保存主接口的请求入参、响应，还可以保存从生产环境 Mock 到的数据及第三方依赖，如图中 Mock 一栏所示。左侧是 Mock 到的主接口及外部调用的请求报文，右侧是对应的响应报文。Mock 数据支持编辑功能，如果对 Mock 的数据不满意，可以手动修改，点击 Save 保存。之后在本地回放时就可以通过修改后的 Mock 数据进行请求。

提示

需要注意的是，无法对主接口的返回值进行修改，因为主接口的返回值是不 Mock 的，AREX 只会对中间过程中调用的第三方依赖进行 Mock，修改才有效。

查看用例

点击 Send 后，会在 Response 的 Headers 中生成一个 arex-replay-id，这意味着本次请求的发送并不是真实的请求，而是一次回放。

固化用例的回放测试

对于固化后的用例集合，AREX 提供了一个 Node.js 脚本来实现固化用例的回归测试：

console.log('hello world')
const MongoClient = require('mongodb').MongoClient;
const mongoUrl = "mongodb://arex:iLoveArex@10.5.153.1:27017/arex_storage_db";
const scheduleEndpoint = 'http://10.5.153.1:8092/api/createPlan'
const appId = 'community-test-0905'
const targetHost = 'http://10.5.153.1:18080'

const client = new MongoClient(mongoUrl);


async function main() {
  await client.connect();
  const db = client.db();
  console.log('Connected successfully to server');

  // query auto pin cases
  const pinedCases = await db.collection('PinnedServletMocker').find({appId: appId}).project({_id: 1, operationName: 1}).toArray();
  const caseGroupByOp = new Map();
  pinedCases.forEach(item => {
    if (!caseGroupByOp.has(item.operationName)) caseGroupByOp.set(item.operationName, [])
    caseGroupByOp.get(item.operationName).push(item._id)
  })

  // query service operations
  const operations = await db.collection('ServiceOperation').find({appId: appId, operationName: {$in: [...new Set(pinedCases.map((item) => item.operationName))]}}).toArray()
  // console.log(operations);

  const createPlanReq = {
    "appId": "community-test-0905",
    "replayPlanType": 2,
    "targetEnv": targetHost,
    "operator": "AREX",
    "operationCaseInfoList": operations.map(op => ({
        "operationId": op._id.toString(),
        "replayIdList": caseGroupByOp.get(op.operationName)
    }))
  }

  const reqStr = JSON.stringify(createPlanReq, null, 4)
  console.log(reqStr)

  const response = await fetch(scheduleEndpoint, {
    method: "POST", // *GET, POST, PUT, DELETE, etc.
    headers: {
      "Content-Type": "application/json",
    },
    body: reqStr,
  });

  return response.status;
}

main()
  .then(console.log)
  .catch(console.error)
  .finally(() => client.close());

以下几项注意根据真实情况修改：

const mongoUrl = "mongodb://arex:iLoveArex@10.5.153.1:27017/arex_storage_db";
const scheduleEndpoint = 'http://10.5.153.1:8092/api/createPlan'
const appId = 'community-test-0905'
const targetHost = 'http://10.5.153.1:18080'

脚本执行完成后，可以在前端报告页面看到回放任务：

使用场景​

固化录制用例​

固化回放用例​

查看固化用例​

固化用例的回放测试​

使用场景

固化录制用例

固化回放用例

查看固化用例

固化用例的回放测试